home *** CD-ROM | disk | FTP | other *** search
/ Aminet 50 / Aminet 50 (2002)(GTI - Schatztruhe)[!][Aug 2002].iso / Aminet / util / boot / ShellUpdate.lha / Documentation / SetENV < prev    next >
Text File  |  2001-12-24  |  2KB  |  59 lines
  1. SetENV
  2.  
  3. Format:        SETENV [<name>] [<string>] [SAVE]
  4. Template:    NAME,SAVE/S,STRING/F
  5. Purpose:    To set a global variable
  6. Path:        Internal
  7. Specification:    SETENV with <name> and <string> arguments creates a new
  8.     global environment variable. The first word after SETENV is taken
  9.     as the <name>. Everything else on the command line is taken as the
  10.     <string> argument. Quotation marks are not required.
  11.  
  12. SETENV with no arguments list the current global variables. Global 
  13. variables are stored in ENV: and are used by all processes in parallel.
  14. However, if a local variable (defined by SET) and a global variable share
  15. the same name, the local variable will be used.
  16.  
  17. Environent variables are called by scripts or other commands by including
  18. a dollar sign ($) in front of the variable name.
  19.  
  20. To remove a global variable definition, use the UNSETENV command.
  21.  
  22. If the SAVE command line switch has been used, the variable will also be
  23. saved out to disk making it permanent, i.e. reset-persistent. The SAVE
  24. keyword must be placed immediately behind the SETENV command as it will
  25. be otherwise interpreted as part of the variable definition. 
  26.  
  27. If SAVE has been specified, the same variable will remain to be defined 
  28. even after a reboot and after a power-down cycle. Permanent environment 
  29. variables will be saved in ENVARC:
  30.  
  31. Examples:
  32.  
  33. 1> SETENV Editor Extras2.0/Tools/MEmacs
  34.  
  35. creates the environment variable Editor which can be used with the More
  36. utility. This specfies the ediro as being MEmacs, loocated in the Tools
  37. drawer of the Extras2.0 disk. The variable Editor is available in any
  38. shell.
  39.  
  40. To make the above choice permanent, use
  41.  
  42. 1> SETENV SAVE Editor Extras2.0/Tools/MEmacs
  43.  
  44. The following line will select the editor "Ed" instead up to the next
  45. reboot:
  46.  
  47. 1> SETENV Editor C:Ed
  48.  
  49.  
  50. Some implementations of the ENV: device will copy environment variables
  51. from the permanent storage device ENVARC: to ENV: only when needed. If
  52. such a device is used, SETENV without arguments will only list the
  53. environment variables that have been used. A complete list can be obtained
  54. by
  55.  
  56. 1> list ENVARC:
  57.  
  58. See also: GETENV, UNSETENV
  59.